home *** CD-ROM | disk | FTP | other *** search
/ User's Choice Windows CD / User's Choice Windows CD (CMS Software)(1993).iso / utility3 / pfe00408.zip / README.TXT < prev   
Text File  |  1993-01-30  |  11KB  |  240 lines
  1.                           Programmer's File Editor
  2.                              Third Beta Release
  3.  
  4. ABSTRACT
  5. --------
  6.  
  7. This is the third beta release of Programmer's File Editor, a programming-
  8. oriented editor for Windows 3.1 and Windows/NT. It can be used at no charge
  9. by any private individual or non-commercial organisation, and can be freely
  10. distributed, provided that no charge is levied other than to cover reasonable
  11. handling costs.
  12.  
  13. It is termed a 'beta release' only to indicate that not all the planned
  14. features and facilities have yet been implemented, and that user feedback can
  15. play a large part in shaping the final product. The code is fully functional,
  16. and PFE is widely used by many people all over the world.
  17.  
  18. PFE includes the following features:
  19.  
  20. - The size of file it can handle is limited only by the total amount of
  21.   virtual memory available
  22. - Essentially no limit on the number of lines a file can contain
  23. - It can edit multiple files, the number being limited only by the
  24.   available system resources
  25. - Files can be edited in multiple windows simultaneously
  26. - Can read and write files in UNIX format using LF as line terminator, with
  27.   automatic format detection
  28. - Most-recently-used list of files allows easy selection between sessions
  29. - Line numbers can be shown in any edit window if required
  30. - Any installed fixed-pitch screen font, including TrueType, can be used in
  31.   edit windows
  32. - The most frequent operations can be performed from buttons on a tear-off
  33.   toolbar with active buttons
  34. - Active status bar reports settings and allows easy alteration of common ones
  35. - Text can be copied and moved by dragging and dropping
  36. - Tabs can be inserted as TAB characters or spaces
  37. - DOS commands, such as compilers, can be run with the output captured
  38.   in an edit window
  39. - An application being developed can be quickly launched from a configurable
  40.   dialog
  41. - Commonly-used text can be inserted in a simple operation from template
  42.   libraries
  43. - Keys can be mapped to functions as required; two-key operation similar
  44.   to MicroEMACS is supported, but with a wider choice of prefix keys
  45. - Multiple sets of key mappings can be stored, and selected as required from
  46.   a dialog or from the command line
  47. - Commonly-used program development tools can be configured into a list
  48.   and started simply from a dialog
  49. - Files can be printed either in total, by line range, or selected text only
  50. - Automatic line indenting and removal of trailing spaces
  51. - Automatic configuration of edit options depending on file type
  52. - Automatic configuration of tab sizes depending on file type
  53. - Automatic brace alignment when editing C source
  54. - Text indent/undent operations
  55. - Optional automatic text wrapping at configurable margin
  56. - Can mail files to MAPI-compliant mailers like Microsoft Mail 3.0
  57. - User-configurable help menu
  58. - Allows Windows to be closed down and DOS to be rebooted from the system menu
  59. - Uses standard MDI methods to be fully compatible with other Windows apps
  60. - All operations are CUA compliant
  61. - Windows can be tiled vertically to maximize width
  62. - Windows/NT 32-bit executable version
  63.  
  64. Additionally, the editor can be controlled by another application across a
  65. DDE client-server link.
  66.  
  67.  
  68. NOTES FROM THE AUTHOR
  69. ---------------------
  70.  
  71. This beta version of PFE represents the third release to be made generally
  72. available. PFE has been under development since October 1991, and on beta
  73. release since July 1992. It's now heavily used by many people all over the
  74. world; this third beta version has fixed many of the reported bugs and
  75. incorporated many of the splendid suggestions sent in by them.
  76.  
  77. At this beta release not all the features planned are implemented. The change
  78. log included in the distribution set gives a history of how PFE has changed
  79. in the course of development, and lists most of the features that should be
  80. complete for the full release. It also gives details of the known bugs that
  81. still await fixing.
  82.  
  83. My original plans to have only three beta releases, and to have version 1
  84. complete by the end of 1992 have proved hopelessly optimistic. There has been
  85. much greater interest in PFE than I had ever anticipated: happily, I have
  86. received far more excellent ideas, and (unhappily) far more bug reports than
  87. I planned for. So the beta program will continue for some time yet, and
  88. version 1 will probably not be finished until Q3 of 1993 (or even later!).
  89. However, when it finally does appear, it will include the shared thoughts and
  90. suggestions of very many real users. It should also be thoroughly battle-
  91. tested and reliable!
  92.  
  93. I would very much appreciate hearing from you if you use PFE and find problems,
  94. or if you can think of ways it could be improved - and even (or is that
  95. 'especially'?) if you just think it's great. Even if the facility you would
  96. like to see appears to be of interest only to you, tell me about it - you'd be
  97. surprised how many ideas in that class have a much wider appeal. I'll try to
  98. fix every reported bug for version 1, but I can't promise to include every
  99. suggested improvement. However, every idea goes into the wish list, and there's
  100. always version 2, or 3, or....
  101.  
  102. You can contact me by e-mail at
  103.  
  104.     alan@uk.ac.lancaster    if you're on the UK JANET network
  105.     alan@lancaster.ac.uk    if you're on the Internet
  106.  
  107. I will try to reply to all the mail I receive.
  108.  
  109.  
  110.  
  111. WHERE TO GET PFE
  112. ----------------
  113.  
  114. I post releases of PFE to three main archive sites:
  115.  
  116. - For the UK Higher Education sector, it's available in the HENSA/micros
  117.   archive on the uk.ac.hensa.micros system in the micros/ibmpc/win/b/b085
  118.   directory
  119.  
  120. - On the Internet, I place copies on two archives:
  121.  
  122.      wsmr-simtel20.army.mil      in directory pd:<msdos.windows3>
  123.      ftp.cica.indiana.edu        in directory /pub/pc/win3/uploads initially;
  124.                                   then in /pub/pc/win3/programr
  125.  
  126.   Currently, files take a very long time to move from the /pub/pc/win3/uploads
  127.   directory on CICA, so look there, and in any sub-directories of it, first
  128.  
  129.   [At the time of writing, CICA is not accepting new uploads. If and when
  130.    they start to take new material again, I will upload this version of PFE]
  131.  
  132. On Usenet, I post an announcement of each release to the
  133. comp.os.ms-windows.announce group, and send the distribution set to the
  134. moderator of the comp.binaries.ms-windows group for posting.
  135.  
  136. Though I do not place it there myself, a copy should be available from
  137. CompuServe in the "General Apps/Info" library of the WINADV forum within a few
  138. days of each release.
  139.  
  140. If you have a favourite BBS or archive that does not yet have a copy, I would
  141. very much appreciate your posting a copy there too.
  142.  
  143.  
  144. CHANGES FROM PREVIOUS RELEASES
  145. ------------------------------
  146.  
  147. The file changes.txt that comes in the release set gives you a complete summary
  148. of the changes made in PFE (as well as a list of what is planned, and of bugs
  149. that remain unfixed). It's well worth looking at this file to see what new
  150. features have been added.
  151.  
  152. Some alterations from the last release may affect the way you work:
  153.  
  154. - Key map files saved with earlier versions will not work with this one; you
  155.   will need to delete them and re-establish your key mappings
  156.  
  157. - As part of the re-organisation of the help file and the help menu, the menu
  158.   item Help|Windows_SDK has been removed. PFE now lets you add up to 5 help
  159.   files of your choice to the menu; consult the help file Commands section
  160.   under "Help Menu" for full details of how to add this customisation
  161.  
  162. - Find and Replace operations now use the common dialogs, which remain on the
  163.   screen until dismissed
  164.  
  165.  
  166.  
  167. NOTES ON THE WINDOWS/NT VERSION
  168. -------------------------------
  169.  
  170. PFE32.EXE is a 32-bit i386 executable for running under the October 1992 beta
  171. version of the Windows/NT Operating System.
  172.  
  173. *******************************************************************************
  174. ** IT IS AN ALPHA BUILD, AND HAS BEEN VERY LITTLE TESTED: PLEASE USE IT WITH **
  175. **                            EXTREME CAUTION                                **
  176. *******************************************************************************
  177.  
  178. Not all the functionality of the Windows/16 version is currently available
  179. under Windows/NT:
  180.  
  181. - It is not possible to run DOS commands with output capture
  182. - It may not be possible to select printer fonts - see below
  183. - Setting screen fonts will probably require the "fix-font-bug=1" flag in the
  184.   [options] section of the initialisation file: see the help file for details
  185.   under the section on the "Options Screen Font Other" command and also see
  186.   below
  187.  
  188. The Windows/NT version has been used only on FAT-based file systems. IT IS
  189. UNLIKELY THAT IT WILL WORK CORRECTLY ON HPFS AND NTFS FILE SYSTEMS; there is
  190. still considerable porting work to be done in this area.
  191.  
  192. The Windows/NT version will look in your Windows/NT directory (normally c:\winnt)
  193. for its initialisation file pfe.ini and default keymap file pfe.key. The same file
  194. format is used, so you can safely copy your Windows 3 files there. PFE32 has
  195. not been tested with its initialisation file mapped to the registry.
  196.  
  197. The help file is common to the Windows/16 and Windows/NT versions.
  198.  
  199.  
  200. Font Selection
  201. --------------
  202.  
  203. Despite using the 'fix-font-bug=1' option described above, you may still not be
  204. able to select fonts for the screen or printer: this is due to what seems to be
  205. a fault in the Windows/NT font manager that does not mark fixed-pitch fonts
  206. correctly. If you can't select fonts from the dialogs, you will need to
  207. configure them manually in the pfe.ini file in the Windows/NT directory.
  208.  
  209. To set the screen font, insert a line like this in the [general] section:
  210.  
  211.         default-screen-font=Courier New,8,400,0
  212.                                 ^       ^  ^
  213.                                 |       |  |
  214.                                 |       |  +--- 400=normal weight, 700=bold
  215.                                 |       +--- size in points
  216.                                 +--- face name
  217.  
  218. Make sure that the font name you give is for a fixed pitch font; PFE will not
  219. work correctly if it isn't.
  220.  
  221. To set a printer font, insert in the [printer-settings] section a line like
  222. this for every printer you use:
  223.  
  224.         HP Deskjet=0,Courier New,6,400,0,0,0,0,0,0
  225.               ^            ^     ^  ^
  226.               |            |     |  |
  227.               |            |     |  +--- 400=normal weight, 700=bold
  228.               |            |     +--- size in points
  229.               |            +--- face name
  230.               +------- printer name
  231.  
  232. Make sure that the font name you give is for a fixed pitch font; PFE will not
  233. work correctly if it isn't.
  234.  
  235.  
  236. --
  237.  
  238. Alan Phillips
  239. February 1 1993
  240.